Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Types and Constants

The Bevel Button and Image Well Content Structure

NEW WITH THE APPEARANCE MANAGER

You can pass a pointer to the bevel button and image well content structure of type ControlButtonContentInfo in the inBuffer parameter of GetControlData to get the resource ID (for resource-based content) or handle (for handle-based content) of a color icon, picture, or icon suite in a bevel button or image well.

struct ControlButtonContentInfo {
   ControlContentType contentType;
   union {
   SInt16         resID;
   CIconHandle    cIconHandle;
   Handle         iconSuite;
   Handle         iconRef;       
   PicHandle      picture;
   }              u;
};
typedef struct ControlButtonContentInfo ControlButtonContentInfo;
typedef ControlButtonContentInfo *ControlButtonContentInfoPtr;

Field Description

contentType

Specifies the bevel button or image well content type and whether the content is text-only, resource-based, or handle-based; see "Bevel Button and Image Well Content Type Constants". The value specified in the contentType field determines which of the other fields in the structure are used.

resID

If the content type specified in the contentType field is kControlContentIconSuiteRes, kControlContentCIconRes, or kControlContentPictRes, this field contains the resource ID of a picture, color icon, or icon suite resource.

cIconHandle

If the content type specified in the contentType field is kControlContentCIconHandle, this field contains a handle to a color icon.

iconSuite

If the content type specified in the contentType field is kControlContentIconSuiteHandle, this field contains a handle to an icon suite.

iconRef

Reserved.

picture

If the content type specified in the contentType field is kControlContentPictHandle, this field contains a handle to a picture.